|
This page last changed on Jul 20, 2011 by rosie@atlassian.com.
What is a 'Field Configuration Scheme'?
A Field Configuration Scheme maps Field Configurations to issue types. A Field Configuration Scheme can be associated with one or more projects.
This means that you can define Field Configurations for a particular issue type in a given project. For example, it is possible to have a separate field configuration for the 'Bug' issue type and the 'Improvement' issue type for the 'Test' Project. For more information, please see the Overview Diagram.
Because field configuration schemes can be associated with more than one project, your administrative workload is minimised as you can reuse the same field configuration for issue type mappings across multiple projects.
Adding a Field Configuration Scheme
- Log in as a user with the 'JIRA Administrators' global permission.
- Select 'Administration' > 'Issues' > 'Fields' > 'Field Configuration Schemes'.
Keyboard shortcut: 'g' + 'g' + type 'co'
- This will bring you to the 'View Field Configuration Schemes' page, which lists all your field configuration schemes (if any exist).
- The 'Add New Field Configuration Scheme' form is located at the bottom of the page. Enter the name of the new configuration on this form, and optionally add a description; then click the 'Add' button.
Screenshot 1: the 'View Field Configuration Schemes' page

|
|
Associating an Issue Type with a Field Configuration
- Log in as a user with the 'JIRA Administrators' global permission.
- Select 'Administration' > 'Issues' > 'Fields' > 'Field Configuration Schemes'.
Keyboard shortcut: 'g' + 'g' + type 'co'
- This will bring you to the 'View_Field_Configuration_Schemes' page, which lists all your field configuration schemes (if any exist).
- Click the 'Configure' link for the Field Configuration Scheme that contains a Field Configuration which you wish to associate with an issue type.
- The 'Configure Field Configuration Scheme' page will appear, showing the scheme's current mappings of Field Configurations to issue types.
If you have not added any field configurations, you will only have the Default Field Configuration to work with.
- The 'Add Issue Type To Field Configuration Association' form is located at the bottom of the page. Select the desired issue type and field configuration, and click the 'Add' button.
Screenshot 2: the 'Configure Field Configuration Scheme' page

Please note:
- An issue type can only have one association within a given configuration scheme.
- If an issue type does not have an association in the scheme, the field configuration associated with the Default entry in the scheme will be used for issues of that type.
Removing an association an Issue Type and a Field Configuration
- Log in as a user with the 'JIRA Administrators' global permission.
- Select 'Administration' > 'Issues' > 'Fields' > 'Field Configuration Schemes'.
- This will bring you to the 'View_Field_Configuration_Schemes' page, which lists all your field configuration schemes (if any exist).
- Click the 'Configure' link for the Field Configuration Scheme that contains a Field Configuration which you wish to no longer associate with an issue type.
- The 'Configure Field Configuration Scheme' page will appear, showing the scheme's current mappings of Field Configurations to issue types.
If you have not added any field configurations, you will only have the Default Field Configuration to work with.
- Click the 'Remove' link next to the issue type you wish to remove from the scheme.
Please note:
- The Default entry cannot be removed from the scheme.
Associating an Issue Type with a different Field Configuration
- Log in as a user with the 'JIRA Administrators' global permission.
- Select 'Administration' > 'Issues' > 'Fields' > 'Field Configuration Schemes'.
- This will bring you to the 'View_Field_Configuration_Schemes' page, which lists all your field configuration schemes (if any exist).
- Click the 'Configure' link for the Field Configuration Scheme that contains a Field Configuration which you wish to associate with a different issue type.
- The 'Configure Field Configuration Scheme' page will appear, showing the scheme's current mappings of Field Configurations to issue types.
If you have not added any field configurations, you will only have the Default Field Configuration to work with.
- Click the 'Edit' link next to the issue type whose field configuration you wish to change.
- Select the new field configuration you would like to associate with this issue type and click the 'Update' button.
Screenshot 3: changing the field configuration with which an issue type is associated

Editing a Field Configuration Scheme
To change the name or description of a Field Configuration Scheme:
- Log in as a user with the 'JIRA Administrators' global permission.
- Select 'Administration' > 'Issues' > 'Fields' > 'Field Configuration Schemes'.
- This will bring you to the 'View_Field_Configuration_Schemes' page, which lists all your field configuration schemes (if any exist).
- Click the 'Edit' link next to the desired field configuration scheme. You will now see the 'Edit Field Configuration Scheme' page.
- Change the name and/or description as necessary, and click the 'Update' button.
Deleting a Field Configuration Scheme
To delete a Field Configuration Scheme:
- Log in as a user with the 'JIRA Administrators' global permission.
- Select 'Administration' > 'Issues' > 'Fields' > 'Field Configuration Schemes'.
- This will bring you to the 'View_Field_Configuration_Schemes' page, which lists all your field configuration schemes (if any exist).
- Click the 'Delete' link next to the desired field configuration scheme. You will be prompted to confirm your deletion
Copying a Field Configuration Scheme
To copy a Field Configuration Scheme:
- Log in as a user with the 'JIRA Administrators' global permission.
- Select 'Administration' > 'Issues' > 'Fields' > 'Field Configuration Schemes'.
- This will bring you to the 'View_Field_Configuration_Schemes' page, which lists all your field configuration schemes (if any exist).
- Click the 'Copy' link next to the field configuration scheme you wish to copy. This will bring you to the 'Copy Field Configuration Scheme' page.
- Enter the name and description of the new field configuration scheme.
- Click the 'Copy' button.
- You will now be directed back the View Field Configuration Scheme page with your new scheme added. The new scheme will have the same configuration as the copied scheme.
Associating a Field Configuration Scheme with a Project
To activate a Field Configuration Scheme, you need to associate it with a project. An association means that the Field Configuration Scheme will now be applied to the chosen project. The issues in that project will use the Field Configuration that is mapped to their issue type by the scheme. Note that you can use Issue Type Schemes to associate issue types with a project.
Note that newly created projects are not associated with any Field Configuration Schemes, and hence use the Default Field Configuration for all issues.
To associate a Field Configuration Scheme with a project:
- Log in as a user with the 'JIRA Administrators' global permission.
- Click 'Projects' and select the project of interest, then click 'Administer Project'.
- You will now see the 'Project Summary' screen (see Defining a Project). On the lower left, in the 'Fields' section, click the name of the current Field Configuration Scheme.
- Click the pencil icon next to the name of the current Field Configuration Scheme.
- This will display a list of all existing field configuration schemes. Select the scheme you want to associate with this project.
Screenshot 4: the 'Associate Field Configuration Scheme to Project' screen
- Click the 'Associate' button. You will be returned to the 'Project Summary' page , with the project now associated with the selected Field Configuration Scheme.
|